Add Trino 478 release note #26726

ebyhr · 2025-09-26T22:26:44Z

Description

Assemble the release notes for the upcoming Trino 478 release.

Additional context and related issues

See https://github.com/trinodb/trino/pulls?q=is%3Apr+is%3Aclosed+milestone%3A478

Release notes

(x) This is not user-visible or is docs only, and no release notes are required.

Verification for each pull request

Format: PR/issue number, ✅ / ❌ rn ✅ / ❌ docs
✅ rn - release note added and verified, or assessed to be not necessary, set to ❌ rn before completion
✅ docs - need for docs assessed and merged, or assessed to be not necessary, set to ❌ docs before completion

25 Sep 2025

Replace VendedCredentials with FileSystemCredentials #26699 ✅ rn ✅ docs
Update dependencies #26711 ✅ rn ✅ docs
Fix suite-compatibility for Trino 477 #26712 ✅ rn ✅ docs
Fix reading map value contains variant null value #26700 ✅ rn ✅ docs
Fix runtime warnings #26713 ✅ rn ✅ docs
Fix preview UI button condition in the classic UI header #26714 ✅ rn ✅ docs
Update Java runtime version to 25.0 (build 36) #26693 ✅ rn ✅ docs
Add tests to TestRowBlock #26706 ✅ rn ✅ docs
Product tests launcher cleanup #26716 ✅ rn ✅ docs

26 Sep 2025

Allow for CTAS table creation to external tables when write are enabled #2669 ✅ rn ✅ docs8
Update airlift to 362 #26717 ✅ rn ✅ docs
Require implementing shutdown method on a Connector #26718 ✅ rn ✅ docs
Validate out of range DateTime value in clickhouse connector #26703 ✅ rn ✅ docs
Add meaningful names to bootstraps #26721 ✅ rn ✅ docs
Upgrade ClickHouse Server version #26723 ✅ rn ✅ docs

28 Sep 2025

Move assertions in BaseSqlServerConnectorTest #26732 ✅ rn ✅ docs

29 Sep 2025

Document branching syntax #26376 ✅ rn ✅ docs
Allow reusing SingleStore container #26734 ✅ rn ✅ docs
Small improvements #26739 ✅ rn ✅ docs
Add toString implementations #26738 ✅ rn ✅ docs
Update dependencies #26740 ✅ rn ✅ docs
Fix batch size condition in AsyncResultIterator #26728 ✅ rn ✅ docs
Clean up PipelinedQueryScheduler #26745 ✅ rn ✅ docs
Fix download links in docs #26733 ✅ rn ✅ docs
Docs - Pinot - Fix default values and typo #26743 ✅ rn ✅ docs

30 Sep 2025

Fix Iceberg memory caching documentation #26758 ✅ rn ✅ docs
Minor improvement in Lakehouse connector #26752 ✅ rn ✅ docs
Avoid calling TypeConverters when injecting a header #26748 ✅ rn ✅ docs
Disable running redshift cloud tests #26762 ✅ rn ✅ docs
Update dependencies & fix checkstyle for 10.11.0 #26761 ✅ rn ✅ docs
Update maven plugins #26764 ✅ rn ✅ docs
CI fixes #26763 ✅ rn ✅ docs
Update google-cloud-sdk to 26.69.0 #26765 ✅ rn ✅ docs
Cleanup revapi exclusions after release #26771 ✅ rn ✅ docs
Add documentation on LDAP Group provider #26081 ✅ rn ✅ docs
Update units to 1.11 #26770 ✅ rn ✅ docs

01 Oct 2025

Fix add_files_from_table due to wrong column count condition #26774 ✅ rn ✅ docs
Add Parquet decryption support for Hive tables #24517 ✅ rn ✅ docs
Cleanup dependencies for oauth2-oidc-sdk #26773 ✅ rn ✅ docs
Fix indentation in testVariantReadNull test #26776 ✅ rn ✅ docs
Improve QueryId/TaskId handling #26769
Update dependencies #26775 ✅ rn ✅ docs
Allow using local staging path in iceberg for sorted writes #26172 ✅ rn ✅ docs
Random improvements here and there #26766 ✅ rn ✅ docs
Cleanup jvm flags #26778 ✅ rn ✅ docs
Remove deprecated EncoderUtil.encodeNullsAsBits #26781 ✅ rn ✅ docs
Remove trailing whitespace and add defaults to LDAP group-mapping docs #26783 ✅ rn ✅ docs
Fix typo in PagesSpatialIndexSupplier #26782 ✅ rn ✅ docs

02 Oct 2025

Use methods in Guava Preconditions #26784 ✅ rn ✅ docs
Planner cleanup #26777 ✅ rn ✅ docs
Fix query plan default viewport in preview UI #26749 ✅ rn ✅ docs
Update minor deps #26785 ✅ rn ✅ docs
Add dependabot for maven dependencies #26790 ✅ rn ✅ docs
Fix findOffsetsForTimestampGreaterOrEqual #26789 ✅ rn ✅ docs
Bump net.openhft:posix from 2.27ea0 to 2.27ea2 #26794 ✅ rn ✅ docs
trino-matching cleanup #26788 ✅ rn ✅ docs
Bump net.openhft:chronicle-core from 2.27ea1 to 2.27ea7 #26793 ✅ rn ✅ docs
Upgrade Oracle docker image for testing to oracle-free 23 #26573 ✅ rn ✅ docs
Convert StageId and TaskId to a record #26795 ✅ rn ✅ docs
Allow using CastDependency for aggregation functions #26804 ✅ rn ✅ docs

03 Oct 2025

Minor fixes to 477 release notes #26808 ✅ rn ✅ docs
Remove stale comment and deprecated constructor from SPI #26809 ✅ rn ✅ docs
Bump com.github.luben:zstd-jni from 1.5.7-4 to 1.5.7-5 #26811 ✅ rn ✅ docs
Remove dependency group updates #26812 ✅ rn ✅ docs
Add redirect guards #26597 ❌ rn ✅ docs
Inline fullId to toString method #26801 ✅ rn ✅ docs
Bump io.github.gitflow-incremental-builder:gitflow-incremental-builder from 4.5.4 to 4.5.6 #26827 ✅ rn ✅ docs
Bump org.jdbi:jdbi3-bom from 3.49.5 to 3.49.6 #26825 ✅ rn ✅ docs
Use monaco editor in Preview UI for improved code formatting performance #26807 ✅ rn ✅ docs
Bump com.azure:azure-sdk-bom from 1.2.38 to 1.3.0 #26829 ✅ rn ✅ docs
Create and drop catalog tasks utilize Metadata class #26797 ✅ rn ✅ docs
Bump dep.aws-sdk.version from 1.12.791 to 1.12.792 #26815 ✅ rn ✅ docs
Bump com.databricks:databricks-jdbc from 2.6.36 to 2.7.4 #26819 ✅ rn ✅ docs
Fix an issue on appendPositions on RowBlockBuilder #26806 ✅ rn ✅ docs
Bump com.mysql:mysql-connector-j from 9.2.0 to 9.4.0 #26838 ✅ rn ✅ docs
Bump org.apache.hive:hive-jdbc from 3.1.3 to 4.1.0 #26835 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.34.8 to 2.34.9 #26833 ✅ rn ✅ docs
Bump org.revapi:revapi-java from 0.28.1 to 0.28.4 #26840 ✅ rn ✅ docs
Fix column level lineage miss when use unnest #26559 ✅ rn ✅ docs
Document GROUP BY AUTO syntax #26646 ✅ rn ✅ docs

04 Oct 2025

Re-enable running redshift cloud tests #26842 ✅ rn ✅ docs
Revert SPI change #26843 ✅ rn ✅ docs

05 Oct 2025

Bump io.airlift:airbase from 308 to 309 #26845 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.34.9 to 2.35.0 #26844 ✅ rn ✅ docs

06 Oct 2025

Bump actions/stale from 10.0.0 to 10.1.0 #26849 ✅ rn ✅ docs
Bump org.codehaus.mojo:exec-maven-plugin from 3.6.0 to 3.6.1 #26847 ✅ rn ✅ docs
Bump it.unimi.dsi:fastutil from 8.5.17 to 8.5.18 #26846 ✅ rn ✅ docs
Bump io.airlift:airbase from 309 to 310 #26848 ✅ rn ✅ docs
Add queryId to OPA requests #26851 ✅ rn ✅ docs
Update ASM to 9.9 to support JDK 26 #26852 ✅ rn ✅ docs
Bump org.apache.lucene:lucene-analysis-common from 10.3.0 to 10.3.1 #26858 ✅ rn ✅ docs
Bump io.airlift:airbase from 311 to 312 #26859 ✅ rn ✅ docs
Bump net.snowflake:snowflake-jdbc from 3.26.1 to 3.27.0 #26857 ✅ rn ✅ docs
Improve performance of PagesIndexComparator for strings #26725 ✅ rn ✅ docs

07 Oct 2025

Bump mongo-java.version from 5.6.0 to 5.6.1 #26856 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.0 to 2.35.1 #26861 ✅ rn ✅ docs
Bump com.azure:azure-core-tracing-opentelemetry from 1.0.0-beta.60 to 1.0.0-beta.61 #26862 ✅ rn ✅ docs
Allow specifying list of allowed retry policies #26628 ✅ rn ✅ docs
Cleanup S3FileSystemExchangeStorage #26864 ✅ rn ✅ docs
Bump io.openlineage:openlineage-java from 1.38.0 to 1.39.0 #26869 ✅ rn ✅ docs
Update units to 1.12 #26870 ✅ rn ✅ docs
Bump dep.okhttp.version from 5.1.0 to 5.2.0 #26871 ✅ rn ✅ docs
Bump dep.flyway.version from 11.13.2 to 11.13.3 #26867 ✅ rn ✅ docs
Fix incorrect results when reading migrated Iceberg Avro files #26866 ✅ rn ✅ docs

08 Oct 2025

Add Hive catalog to DefaultIcebergQueryRunnerMain #26873 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.1 to 2.35.2 #26872 ✅ rn ✅ docs
Bump com.dylibso.chicory:bom from 1.5.2 to 1.5.3 #26876 ✅ rn ✅ docs
Add fast path for single partition in PagePartitioner #26741 ✅ rn ✅ docs
Upgrade airbase to 313 #26877 ✅ rn ✅ docs
Add support for Zstd, Brotli, Gzip compression to client #26875 ✅ rn ✅ docs
Update Jetty to 12.1.2 #26881 ✅ rn ✅ docs
Improve BlockBuilder#appendRange null handling #26800 ✅ rn ✅ docs

09 Oct 2025

Set a longer timeout duration for Alluxio filesystem test #26885 ✅ rn ✅ docs
Bump dep.nessie.version from 0.105.3 to 0.105.4 #26886 ✅ rn ✅ docs
Set Calendar type used for temporal types in ORC footer #26507 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.2 to 2.35.3 #26887 ✅ rn ✅ docs
Disallow dropping sort column explicitly in Iceberg #26884 ✅ rn ✅ docs
Document client disallowLocalRedirect property #26890 ✅ rn ✅ docs
Disable server-side compression #26889 ✅ rn ✅ docs
Allow multiple directories as plugin source by extending the plugin.dir #26855 ✅ rn ✅ docs
Cleanup JDK provider in tests #26891 ✅ rn ✅ docs
Fix DevelopmentServer plugin.dir configuration #26898 ✅ rn ✅ docs
Use Path instead of a File for plugin.dir #26899 ✅ rn ✅ docs
Fix compilation error in DevelopmentServer #26901 ✅ rn ✅ docs
Harden pre-signed URI tests #26894 ✅ rn ✅ docs
Fix domain-wide delegation for Google Sheets connector #26501 ✅ rn ✅ docs

10 Oct 2025

Bump dep.okio.version from 3.16.0 to 3.16.1 #26906 ✅ rn ✅ docs
Bump dep.flyway.version from 11.13.3 to 11.14.0 #26908 ✅ rn ✅ docs
Bump com.google.cloud:libraries-bom from 26.69.0 to 26.70.0 #26909 ✅ rn ✅ docs
Bump com.google.cloud.bigdataoss:gcs-connector from 3.1.8 to 3.1.9 #26907 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.3 to 2.35.4 #26911 ✅ rn ✅ docs
Bump dep.okhttp.version from 5.2.0 to 5.2.1 #26910 ✅ rn ✅ docs
Bump redis.clients:jedis from 6.2.0 to 7.0.0 #26913 ✅ rn ✅ docs

12 Oct 2025

Bump net.datafaker:datafaker from 2.5.1 to 2.5.2 #26923 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.4 to 2.35.5 #26924 ✅ rn ✅ docs

13 Oct 2025

Improve performance of Merge for MarkDistinct #26759 ✅ rn ✅ docs
Use pre-order stages ordering in EXPLAN output #26655
Cleanup OutputBufferMemoryManager and peak memory calculations #26883 ✅ rn ✅ docs
Output metrics about remove_orphan_files execution #26661 ✅ rn ✅ docs
Use faster alternatives to inline patterns #26928 ✅ rn ✅ docs
Update limit pushdown for Oracle #26926 ✅ rn ✅ docs

14 Oct 2025

Lazily build MongoClient in MongoClientModule #26912 ✅ rn ✅ docs
Bump com.microsoft.sqlserver:mssql-jdbc from 13.2.0.jre11 to 13.2.1.jre11 #26936 ✅ rn ✅ docs
Bump io.airlift:bom from 365 to 366 #26935 ✅ rn ✅ docs
Add gcs.auth-type configuration #26681 ✅ rn ✅ docs
Fix Delta Lake test failure after airbase update #26942 ✅ rn ✅ docs
Bump io.airlift:airbase from 314 to 315 #26931 ✅ rn ✅ docs
Bump dep.swagger.version from 2.2.38 to 2.2.39 #26932 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.5 to 2.35.6 #26934 ✅ rn ✅ docs
Stop early if no allowed entry types in v2 checkpoint #26940 ✅ rn ✅ docs
Fix query splits timeline in preview UI to prevent blank screen #26920 ✅ rn ✅ docs
Disable Snowflake tests #26945 ✅ rn ✅ docs
Bump io.projectreactor.netty:reactor-netty-core from 1.2.10 to 1.2.11 #26950 ✅ rn ✅ docs
Bump dep.okio.version from 3.16.1 to 3.16.2 #26954 ✅ rn ✅ docs
Bump io.airlift:airbase from 315 to 316 #26955 ✅ rn ✅ docs
Use longer table name in tests #26956 ✅ rn ✅ docs
Bump com.databricks:databricks-jdbc from 2.7.4 to 3.0.1 #26933 ✅ rn ✅ docs

15 Oct 2025

Disable TestIcebergS3TablesConnectorSmokeTest.testSelectInformationSchemaTables #26958 ✅ rn ✅ docs
Deprecate io.trino.spi.type.Type#appendTo #26922 ✅ rn ✅ docs
Dynamic catalogs improvements #26918 ✅ rn ✅ docs
Stop running product tests with Databricks 11.3 LTS #26959 ✅ rn ✅ docs
Use secured hydra endpoints for PTs #26948 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.6 to 2.35.7 #26960 ✅ rn ✅ docs
Document Calendar ORC metadata limitation #26874 ✅ rn ✅ docs
Improve TestAlluxioFileSystem robustness #26946 ✅ rn ✅ docs
Bump org.testcontainers:testcontainers-bom from 1.21.3 to 2.0.0 #26961 ✅ rn ✅ docs
Plan queries with and without EXPLAIN ANALYZE the same way #26938 ✅ rn ✅ docs
Use bulk BlockBuilder APIs for appending range of blocks #26964 ✅ rn ✅ docs
Avoid null pointer exceptions from empty tables without snapshot #26970 ✅ rn ✅ docs
Filter queries by trace token in the web UI #26447 ✅ rn ✅ docs

16 Oct 2025

Revert "Disable Snowflake tests" #26953 ✅ rn ✅ docs
Simplify io.trino.spi.PageSorter interface #26965 ✅ rn ✅ docs
Test optimize_manifests without snapshot in Iceberg #26971 ✅ rn ✅ docs
Bump org.opensearch:opensearch-testcontainers from 3.0.2 to 4.0.0 #26974 ✅ rn ✅ docs
Bump io.netty:netty-bom from 4.2.6.Final to 4.2.7.Final #26978 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.7 to 2.35.8 #26977 ✅ rn ✅ docs
Bump dep.avro.version from 1.12.0 to 1.12.1 #26976 ✅ rn ✅ docs
Bump io.airlift:airbase from 316 to 317 #26973 ✅ rn ✅ docs
Bump dep.flyway.version from 11.14.0 to 11.14.1 #26975 ✅ rn ✅ docs
Replace deprecated NestedField.of with NestedField.optional in Iceberg #26972 ✅ rn ✅ docs
Remove unused snappy-java dependency in trino-parquet #26982 ✅ rn ✅ docs
Expose /v1/integrations/gateway/metrics #26548 ✅ rn ✅ docs
Remove HiveBlockEncodingSerde #26989 ✅ rn ✅ docs

17 Oct 2025

Fix expected error message of BigQuery wildcard table #26990 ✅ rn ✅ docs
Increase timeout for github/actions/setup to 15 minutes #27002 ✅ rn ✅ docs
Bump dep.nessie.version from 0.105.4 to 0.105.5 #26994 ✅ rn ✅ docs
Add variant type to type mapping section in Delta Lake #27003 ✅ rn ✅ docs
Don't reuse a table name in testCreateTableWithLongColumnName #26992 ✅ rn ✅ docs
Make query JSON more compact for UI #26988 ✅ rn ✅ docs
Bump org.testcontainers:testcontainers-bom from 2.0.0 to 2.0.1 #26998 ✅ rn ✅ docs
Bump com.nimbusds:oauth2-oidc-sdk from 11.29.2 to 11.30 #26995 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.8 to 2.35.9 #26999 ✅ rn ✅ docs
Bump io.airlift:bom from 366 to 367 #26997 ✅ rn ✅ docs
Load initial catalogs in TestingTrinoServer #26986 ✅ rn ✅ docs
Bump com.amazon.redshift:redshift-jdbc42 from 2.1.0.30 to 2.2.0 #26996 ✅ rn ✅ docs

18 Oct 2025

Fix case typo in NativeLogicalTypesAvroTypeManager#validateLogicalType #27009 ✅ rn ✅ docs
Fix null pointer exception in UI query resource when URL does not have a query string #27011 ✅ rn ✅ docs
Re-throw StorageException as IOException #27007 ✅ rn ✅ docs

20 Oct 2025

Filter hive splits on $path constraints #27000 ✅ rn ✅ docs
Improve HashBuilderOperator unspill parallelism #26076 ✅ rn ✅ docs
Replace deprecated TrinoContainer #27008 ✅ rn ✅ docs
Bump org.codehaus.mojo:exec-maven-plugin from 3.6.1 to 3.6.2 #27018 ✅ rn ✅ docs
Bump com.github.oshi:oshi-core from 6.9.0 to 6.9.1 #27016 ✅ rn ✅ docs
Fix dynamic catalogs in tests #27012 ✅ rn ✅ docs

21 Oct 2025

Cleanup node for JDBC compatibility tests #27021 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.9 to 2.35.10 #27017 ✅ rn ✅ docs
Bump io.airlift:airbase from 317 to 319 #27028 ✅ rn ✅ docs
Fix DROP CATALOG spurious failure if cleanupQuery implemented #27025 ✅ rn ✅ docs
Bump com.github.luben:zstd-jni from 1.5.7-5 to 1.5.7-6 #27027 ✅ rn ✅ docs
Bump io.airlift:bom from 367 to 368 #27033 ✅ rn ✅ docs
Use LongAdder over AtomicLong when capturing metrics #27035 ✅ rn ✅ docs
Fix transactional table alter to include thrift catalog name #27032 ✅ rn ✅ docs
Throw a correct exception from SqlServerClient#listSchemas #27031 ✅ rn ✅ docs

22 Oct 2025

Fix SHOW CREATE SCHEMA failure due to unsupported properties #26979 ✅ rn ✅ docs
Bump dep.graalvm.version from 25.0.0 to 25.0.1 #27039 ✅ rn ✅ docs
Fix typo in null check message #27034 ✅ rn ✅ docs
Restrict logical navigations to the running match in running semantics #27006 ✅ rn ✅ docs
Collect NDV stats on all columns when replacing Iceberg tables #27014 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.10 to 2.35.11 #27040 ✅ rn ✅ docs
Disable testIcebergTablesSystemTable in S3 Tables #27042 ✅ rn ✅ docs
Exclude unused Alluxio dependencies #27037 ✅ rn ✅ docs
Fix typo in test #27046 ✅ rn ✅ docs
Add build-success marker job to ci.yml #27036 ✅ rn ✅ docs
Make PipelineStatus a record class #27050 ✅ rn ✅ docs
Update tableReplace javadoc of ConnectorMetadata#getStatisticsCollectionMetadataForWrite method #27048 ✅ rn ✅ docs

23 Oct 2025

Fix failures for EXPLAIN and EXPLAIN ANALYZE on OPTIMIZE queries #26670 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.35.11 to 2.36.0 #27061 ✅ rn ✅ docs
Bump io.airlift:airbase from 319 to 321 #27060 ✅ rn ✅ docs
Remove unused ConnectorSplit.getSplitInfo method #27063 ✅ rn ✅ docs
Ban AWS SDK v1 usage in new code #27005 ✅ rn ✅ docs
Bump io.airlift:airbase from 321 to 322 #27065 ✅ rn ✅ docs
Bump io.airlift:bom from 368 to 369 #27064 ✅ rn ✅ docs

24 Oct 2025

Introduce ConnectorContextModule #27054 ✅ rn ✅ docs
Remove separate docs GitHub workflow #27070 ✅ rn ✅ docs
Fix flaky test TestAlluxioFileSystem and TestAlluxioFileSystemExchangeManager #27072 ✅ rn ✅ docs
Bump software.amazon.awssdk:bom from 2.36.0 to 2.36.1 #27084 ✅ rn ✅ docs
Provide safe default implementation of getTableHandle #27047 ✅ rn ✅ docs
Restore table of contents at the top of DEVELOPMENT.md #27090 ✅ rn ✅ docs
Revert "Expose /v1/integrations/gateway/metrics for Trino Gateway" #27092 ✅ rn ✅ docs
Fix ci workflow on master #27094 ✅ rn ✅ docs

Summary by Sourcery

Add the Sphinx release notes page for Trino version 478 and register it in the documentation toctree.

Documentation:

Create docs/src/main/sphinx/release/release-478.md with detailed Trino 478 release notes covering general, security, Web UI, Docker image, and connector changes
Update docs/src/main/sphinx/release.md to include the new release-478 entry in the toctree

wendigo · 2025-09-27T10:34:48Z

@ebyhr I've added two more entries

docs/src/main/sphinx/release/release-478.md

Copilot

Pull Request Overview

This PR adds the release notes for Trino version 478, documenting new features, bug fixes, and improvements across various components and connectors.

Creates a comprehensive release notes document for version 478 with changes across general functionality, web UI, Docker, and multiple connectors
Adds the new release notes file to the documentation index to make it accessible

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
docs/src/main/sphinx/release/release-478.md	New release notes document containing features and fixes for Trino 478
docs/src/main/sphinx/release.md	Updated table of contents to include the new release-478 entry

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-10-04T23:56:16Z

docs/src/main/sphinx/release/release-478.md

@@ -0,0 +1,106 @@
+# Release 478 (dd Oct 2025)


The release date placeholder 'dd Oct 2025' should be replaced with the actual release date.

Suggested change

# Release 478 (dd Oct 2025)

# Release 478 (3 Jun 2024)

docs/src/main/sphinx/release/release-478.md

wendigo · 2025-10-16T08:14:59Z

docs/src/main/sphinx/release/release-478.md

+
+## Docker image
+
+* Run Trino on JDK 25.0.0 (build 36). ({issue}`26693`)


FYI: This will change to 25.0.1 soon

Why are we treating this as user visible? Because we support attaching external plugins to Trino run from official docker image?

docs/src/main/sphinx/release/release-478.md

mosabua

A couple of changes and final clean up needed

docs/src/main/sphinx/release/release-478.md

Co-Authored-By: Cole Bowden <[email protected]>

sourcery-ai · 2025-10-23T06:07:10Z

Reviewer's Guide

This PR integrates the Trino 478 release notes into the documentation by updating the Sphinx toctree and adding a new release page with categorized change entries.

Flow diagram for Trino 478 release note integration

flowchart TD
    A["Update Sphinx toctree in release.md"] --> B["Add release/release-478 to toctree"]
    B --> C["Create release/release-478.md with categorized release notes"]
    C --> D["Documentation includes Trino 478 release notes"]

File-Level Changes

Change	Details	Files
Include new release in documentation index	Added "release/release-478" entry to the Sphinx toctree	`docs/src/main/sphinx/release.md`
Add detailed release note page for version 478	Created release-478.md with sections for General, Security, Web UI, Docker image, connectors, and SPI Populated each section with bullet entries referencing relevant issue numbers	`docs/src/main/sphinx/release/release-478.md`

Tips and commands

Interacting with Sourcery

Trigger a new review: Comment @sourcery-ai review on the pull request.
Continue discussions: Reply directly to Sourcery's review comments.
Generate a GitHub issue from a review comment: Ask Sourcery to create an
issue from a review comment by replying to it. You can also reply to a
review comment with @sourcery-ai issue to create an issue from it.
Generate a pull request title: Write @sourcery-ai anywhere in the pull
request title to generate a title at any time. You can also comment
@sourcery-ai title on the pull request to (re-)generate the title at any time.
Generate a pull request summary: Write @sourcery-ai summary anywhere in
the pull request body to generate a PR summary at any time exactly where you
want it. You can also comment @sourcery-ai summary on the pull request to
(re-)generate the summary at any time.
Generate reviewer's guide: Comment @sourcery-ai guide on the pull
request to (re-)generate the reviewer's guide at any time.
Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
pull request to resolve all Sourcery comments. Useful if you've already
addressed all the comments and don't want to see them anymore.
Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
request to dismiss all existing Sourcery reviews. Especially useful if you
want to start fresh with a new review - don't forget to comment
@sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

Enable or disable review features such as the Sourcery-generated pull request
summary, the reviewer's guide, and others.
Change the review language.
Add, remove or edit custom review instructions.
Adjust other review settings.

Getting Help

Contact our support team for questions or feedback.
Visit our documentation for detailed guides and information.
Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

sourcery-ai

Hey there - I've reviewed your changes and they look great!

Prompt for AI Agents

Please address the comments from this code review:

## Individual Comments

### Comment 1
<location> `docs/src/main/sphinx/release/release-478.md:16-17` </location>
<code_context>
+* Ensure that queries with and without `EXPLAIN ANALYZE` are planned identically.
+  way. ({issue}`26938`)
</code_context>

<issue_to_address>
**issue (typo):** Remove the extraneous 'way.' fragment at the end of the sentence.

'way.' is likely a typo and should be deleted to improve clarity.

```suggestion
* Ensure that queries with and without `EXPLAIN ANALYZE` are planned identically. ({issue}`26938`)
```
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

docs/src/main/sphinx/release/release-478.md

Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>

Copilot

Pull Request Overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

docs/src/main/sphinx/release/release-478.md

findepi · 2025-10-23T17:07:08Z

FYI, i changed the target branch of this PR

because of Docs-only or README-changing PRs cannot be merged #27068
it now targets source of Remove separate docs GitHub workflow #27070 PR (the fix for that issue)
it will auto-udpate back to master when that PR is merged

colebow · 2025-10-23T17:08:17Z

Very funny (and unhelpful) that Copilot is randomly suggesting different PR numbers.

findepi · 2025-10-23T17:10:32Z

@colebow thanks for noticing!

BTW Whenever you see a bot's comment, like these copilot's, that you verified to be unhelpful, please resolve them (ideally along with thumb down reaction, but at least resolve)

findepi · 2025-10-24T07:03:05Z

docs/src/main/sphinx/release/release-478.md

+* Add `retry-policy.allowed` configuration property to specify which retry
+  policies can be selected by the user. ({issue}`26628`)


Suggested change

* Add `retry-policy.allowed` configuration property to specify which retry

policies can be selected by the user. ({issue}`26628`)

* Add `retry-policy.allowed` configuration property to specify which query retry

policies can be selected by the user. ({issue}`26628`)

findepi · 2025-10-24T07:05:11Z

docs/src/main/sphinx/release/release-478.md

+* Add `retry-policy.allowed` configuration property to specify which retry
+  policies can be selected by the user. ({issue}`26628`)
+* Add support for loading plugins from multiple directories. ({issue}`26855`)
+* Add the `/v1/integrations/gateway` endpoint for integration with Trino Gateway. ({issue}`26548`)


Suggested change

* Add the `/v1/integrations/gateway` endpoint for integration with Trino Gateway. ({issue}`26548`)

* Add the `/v1/integrations/gateway` endpoint that exposes additional cluster metrics for Trino Gateway. ({issue}`26548`)

findepi · 2025-10-24T07:06:08Z

docs/src/main/sphinx/release/release-478.md

+  policies can be selected by the user. ({issue}`26628`)
+* Add support for loading plugins from multiple directories. ({issue}`26855`)
+* Add the `/v1/integrations/gateway` endpoint for integration with Trino Gateway. ({issue}`26548`)
+* Allow dropping an uninitialized catalog that failed to load. ({issue}`26918`)


do we want to quantify this with "When using dynamic catalogs" or similar?

* When using dynamic catalogs, allow dropping ...

findepi · 2025-10-24T07:09:28Z

docs/src/main/sphinx/release/release-478.md

+* Add support for loading plugins from multiple directories. ({issue}`26855`)
+* Add the `/v1/integrations/gateway` endpoint for integration with Trino Gateway. ({issue}`26548`)
+* Allow dropping an uninitialized catalog that failed to load. ({issue}`26918`)
+* Improve performance of queries with an `ORDER BY` clause. ({issue}`26725`)


Suggested change

* Improve performance of queries with an `ORDER BY` clause. ({issue}`26725`)

* Improve performance of queries with an `ORDER BY` clause using `varchar` or `varbinary` types. ({issue}`26725`)

findepi · 2025-10-24T07:19:27Z

docs/src/main/sphinx/release/release-478.md

+* Improve performance of queries with joins which spill to disk. ({issue}`26076`)
+* Fix potential incorrect results when reading `row` type. ({issue}`26806`)
+* Return all catalogs, including uninitialized ones, for queries from `metadata.catalogs`. ({issue}`26918`)
+* Ensure that queries with and without `EXPLAIN ANALYZE` are planned identically. ({issue}`26938`)


❤️

this is a bug fix, so it's best to start with "Fix"

Suggested change

* Ensure that queries with and without `EXPLAIN ANALYZE` are planned identically. ({issue}`26938`)

* Fix `EXPLAIN ANALYZE` planning so that it executes with the same plan as would be used to execute the query being analyzed. ({issue}`26938`)

findepi · 2025-10-24T07:26:46Z

docs/src/main/sphinx/release/release-478.md

+* Propagate `queryId` to [Open Policy Agent](/security/opa-access-control)
+  authorizer. ({issue}`26851`)
+
+## Web UI


The docs say "The Preview Web UI is not suitable for production usage, and only available for testing and evaluation purposes."
Thus, any changes in that component are irrelevant from end user / trino operator standpoint. Release notes are for end users' and operators' consumption.

Let's remove all entries pertaining the preview web ui

findepi · 2025-10-24T07:27:45Z

docs/src/main/sphinx/release/release-478.md

+
+## Delta Lake connector
+
+* Fix failure when reading `map` type with value type is `json` and value is `NULL`. ({issue}`26700`)


Suggested change

* Fix failure when reading `map` type with value type is `json` and value is `NULL`. ({issue}`26700`)

* Fix failure when reading `map` type with `json` value type when a value is `NULL`. ({issue}`26700`)

findepi · 2025-10-24T07:33:53Z

docs/src/main/sphinx/release/release-478.md

+* Add support for reading encrypted Parquet files. ({issue}`24517`, {issue}`9383`)
+* Deprecate the `gcs.use-access-token` configuration property. Use `gcs.auth-type` instead. ({issue}`26681`)
+* Improve performance of queries using complex predicates on `$path` column. ({issue}`27000`)
+* Prevent writing invalid dates and timestamps before `1582-10-15` by the ORC writer. ({issue}`26507`)


this is a bug fix

Suggested change

* Prevent writing invalid dates and timestamps before `1582-10-15` by the ORC writer. ({issue}`26507`)

* Fix writing invalid dates and timestamps before `1582-10-15` when writing ORC files by setting calendar type in the file footer. Previously, Trino did not set the calendar type in the file footer, and values before `1582-10-15` could be read incorrectly by other query engines such as Apache Hive. ({issue}`26507`)

@marcinsbd @raunaqmorarka does this apply to Iceberg connector too?

findepi · 2025-10-24T07:37:32Z

docs/src/main/sphinx/release/release-478.md

+
+* Improve performance when writing sorted tables and `iceberg.sorted-writing.local-staging-path`
+ is set. ({issue}`24376`)
+* Return execution metrics while running the `remove_orphan_files` procedure. ({issue}`26661`)


it's not "procedure". The code calls this "table procedure"
But the docs calls it "command" https://trino.io/docs/current/connector/iceberg.html#remove-orphan-files

Suggested change

* Return execution metrics while running the `remove_orphan_files` procedure. ({issue}`26661`)

* Return execution metrics while running the `remove_orphan_files` command. ({issue}`26661`)

findepi · 2025-10-24T07:42:11Z

docs/src/main/sphinx/release/release-478.md

+
+## SPI
+
+* Require `shutdown` to be implemented by the `Connector`. ({issue}`26718`)


Connector is the name of the interface connectors implement.
The interface does not implement shutdown. Quite contrary, it lost its default implementation.

Suggested change

* Require `shutdown` to be implemented by the `Connector`. ({issue}`26718`)

* Remove default implementation from `Connector.shutdown()`. ({issue}`26718`)

findepi · 2025-10-24T07:48:40Z

docs/src/main/sphinx/release/release-478.md

+* Add `retry-policy.allowed` configuration property to specify which retry
+  policies can be selected by the user. ({issue}`26628`)
+* Add support for loading plugins from multiple directories. ({issue}`26855`)
+* Add the `/v1/integrations/gateway` endpoint for integration with Trino Gateway. ({issue}`26548`)


BTW I am not convinced we should have added that.
Trino and Trino Gateway are both projects we manage, so we can have coupling between them. That does not mean we should or want such coupling. Everything is a trade off, of course. If this endpoint exposes information previously unavailable, and also interesting to Trino Gateway only, we perhaps want to have it. But it doesn't look like this is the case here. The endpoint exposes cluster utilization metrics (memory, load), which are generally useful for observability and also for any other query routing logic. We should expose them in gateway-agnostic manner, rather than build a public-but-do-not-use-kind-of-internal-yet-public API.

cc @andythsu @wendigo @martint

We've discussed that already and settled on the decision that it's ok to have a client specific endpoint (like we have for the UI). We can revisit this decision but if it blocks the release we should just revert the change and move on

ok to have a client specific endpoint (like we have for the UI)

UI is not the best example, because it's maintained within this repo. The UI endpoints can change as the UI needs evolve.

This new endpoint is different. It's meant for the Trino Gateway, so in theory it should not be used by any other software. Any other query routing software will needs its own endpoint, which is quite undesirable. All this while the information exposed is no way trino gateway specific and could be exposed in a more reusable manner.

We can revisit this decision but if it blocks the release we should just revert the change and move on

Agreed!

-> https://github.com/trinodb/trino/pull/27089/files#r2459921217

I agree with you that it's undesirable to have an endpoint for each service and it should be in a reusable manner

IMO, the coupling between Trino Gateway and Trino is inevitable. If Trino changes, Trino Gateway will need to change. For example, in this PR because Trino 477 removed some of the jmx stats, which caused Trino Gateway to fail, we had to pin Trino version to 476 and look for workarounds.

For this endpoint specifically, yes the data it returns can be useful for other software as well and should be gateway-agnostic. But I think the point is that each software should deserve its own dedicated endpoint so that they are not affected by unintentional changes. Other software owners are welcome, of course, to use this endpoint, but it is their responsibility to make sure their software doesn't break at all times, even after we roll out new changes to this endpoint. It's another way of saying there's no SLA on this endpoint if they use it, whereas if we create a generic endpoint, there's implied SLA

At the end of the day, if other query routing logic software needs similar data to be returned, they will likely end up with similar code in their endpoint. Yes this results in duplicate code. But we can look into how to extract common logic to a helper function. At that point, maybe we will find some discrepancies in these seemingly-similar looking endpoints.

But I think the point is that each software should deserve its own dedicated endpoint so that they are not affected by unintentional changes.

I appreciate the openness but I doubt that would be want we would actually want to maintain in the project.

BTW trino already exports tons of metrics in standard format (that's why jmx became obsolete), so i don't quite yet understand why we need dedicated endpoints just for selected metrics useful for selected use case

docs/src/main/sphinx/release/release-478.md

findepi · 2025-10-24T11:18:13Z

it will auto-udpate back to master when that PR is merged

it's how i saw it working many times, but this time it did not work.
sorry

findepi · 2025-10-24T11:26:28Z

unfortunately it is not possible to reopen this PR, even after i recreated the base branch
i copied current state of this PR to a new one

Add Trino 478 release notes #27089

i will go over recent comments and apply them as separate fixup there.

cla-bot bot added the cla-signed label Sep 26, 2025

github-actions bot added release-notes docs labels Sep 26, 2025

ebyhr force-pushed the ebi/release-note-478 branch from 7ba941a to 64e2c9c Compare September 26, 2025 22:49

ebyhr force-pushed the ebi/release-note-478 branch 3 times, most recently from e51817f to 76113ca Compare October 2, 2025 01:37

martint reviewed Oct 2, 2025

View reviewed changes

ebyhr force-pushed the ebi/release-note-478 branch 3 times, most recently from 72cb5a4 to f11e381 Compare October 4, 2025 01:18

ebyhr requested a review from Copilot October 4, 2025 23:55

Copilot AI reviewed Oct 4, 2025

View reviewed changes

ebyhr force-pushed the ebi/release-note-478 branch 3 times, most recently from 60a2313 to 57aaf2c Compare October 10, 2025 00:15

ebyhr force-pushed the ebi/release-note-478 branch 4 times, most recently from b011102 to 7299817 Compare October 16, 2025 06:32

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Show resolved Hide resolved

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

wendigo reviewed Oct 16, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

ebyhr force-pushed the ebi/release-note-478 branch from fc92c59 to 56b8440 Compare October 21, 2025 22:46

mosabua requested changes Oct 22, 2025

View reviewed changes

ebyhr force-pushed the ebi/release-note-478 branch from f2013f8 to 04c1acc Compare October 22, 2025 23:47

colebow reviewed Oct 23, 2025

View reviewed changes

fixup! Add Trino 478 release note

412d267

Co-Authored-By: Cole Bowden <[email protected]>

ebyhr force-pushed the ebi/release-note-478 branch from b06fbfb to 412d267 Compare October 23, 2025 02:22

ebyhr marked this pull request as ready for review October 23, 2025 06:06

sourcery-ai bot reviewed Oct 23, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Outdated Show resolved Hide resolved

Update docs/src/main/sphinx/release/release-478.md

da31f20

Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>

findepi requested review from Copilot and mosabua October 23, 2025 09:16

Copilot AI reviewed Oct 23, 2025

View reviewed changes

findepi mentioned this pull request Oct 23, 2025

Docs-only or README-changing PRs cannot be merged #27068

Closed

findepi changed the base branch from master to findepi/docs-checks October 23, 2025 17:06

colebow approved these changes Oct 23, 2025

View reviewed changes

findepi approved these changes Oct 24, 2025

View reviewed changes

findepi requested changes Oct 24, 2025

View reviewed changes

findepi force-pushed the findepi/docs-checks branch from 212e26e to a0d9b10 Compare October 24, 2025 07:50

losipiuk reviewed Oct 24, 2025

View reviewed changes

docs/src/main/sphinx/release/release-478.md Show resolved Hide resolved

findepi deleted the branch trinodb:findepi/docs-checks October 24, 2025 11:15

findepi closed this Oct 24, 2025

findepi mentioned this pull request Oct 24, 2025

Add Trino 478 release notes #27089

Draft

ebyhr deleted the ebi/release-note-478 branch October 24, 2025 23:56

andythsu mentioned this pull request Oct 25, 2025

Expose metrics for Trino Gateway to consume #26549

Open


		## Docker image

		* Run Trino on JDK 25.0.0 (build 36). ({issue}`26693`)

		* Add `retry-policy.allowed` configuration property to specify which retry
		policies can be selected by the user. ({issue}`26628`)

	* Add the `/v1/integrations/gateway` endpoint for integration with Trino Gateway. ({issue}`26548`)
	* Add the `/v1/integrations/gateway` endpoint that exposes additional cluster metrics for Trino Gateway. ({issue}`26548`)

	* Improve performance of queries with an `ORDER BY` clause. ({issue}`26725`)
	* Improve performance of queries with an `ORDER BY` clause using `varchar` or `varbinary` types. ({issue}`26725`)

	* Ensure that queries with and without `EXPLAIN ANALYZE` are planned identically. ({issue}`26938`)
	* Fix `EXPLAIN ANALYZE` planning so that it executes with the same plan as would be used to execute the query being analyzed. ({issue}`26938`)


		## Delta Lake connector

		* Fix failure when reading `map` type with value type is `json` and value is `NULL`. ({issue}`26700`)

	* Prevent writing invalid dates and timestamps before `1582-10-15` by the ORC writer. ({issue}`26507`)
	* Fix writing invalid dates and timestamps before `1582-10-15` when writing ORC files by setting calendar type in the file footer. Previously, Trino did not set the calendar type in the file footer, and values before `1582-10-15` could be read incorrectly by other query engines such as Apache Hive. ({issue}`26507`)

	* Return execution metrics while running the `remove_orphan_files` procedure. ({issue}`26661`)
	* Return execution metrics while running the `remove_orphan_files` command. ({issue}`26661`)


		## SPI

		* Require `shutdown` to be implemented by the `Connector`. ({issue}`26718`)

	* Require `shutdown` to be implemented by the `Connector`. ({issue}`26718`)
	* Remove default implementation from `Connector.shutdown()`. ({issue}`26718`)

Add Trino 478 release note #26726

Add Trino 478 release note #26726

Conversation

ebyhr commented Sep 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Additional context and related issues

Release notes

Verification for each pull request

25 Sep 2025

26 Sep 2025

28 Sep 2025

29 Sep 2025

30 Sep 2025

01 Oct 2025

02 Oct 2025

03 Oct 2025

04 Oct 2025

05 Oct 2025

06 Oct 2025

07 Oct 2025

08 Oct 2025

09 Oct 2025

10 Oct 2025

12 Oct 2025

13 Oct 2025

14 Oct 2025

15 Oct 2025

16 Oct 2025

17 Oct 2025

18 Oct 2025

20 Oct 2025

21 Oct 2025

22 Oct 2025

23 Oct 2025

24 Oct 2025

Summary by Sourcery

Uh oh!

wendigo commented Sep 27, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Oct 4, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

mosabua left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ebyhr commented Sep 26, 2025 •

edited

Loading

findepi Oct 24, 2025 •

edited

Loading